xphoon

Section: User Commands (1)
Updated: 26 August 1988
Index Return to Main Contents

NAME

xphoon - set the X root window to display the PHase of the mOON

SYNOPSIS

xphoon [ -b ] [ -t <interval> ] [ -display <display> ]

DESCRIPTION

Xphoon sets the X root window to display a picture of the moon in its current phase, including the partial lighting of the dark side by reflected earthlight.

The -b flag defeats the earthlight feature, forcing the dark side to be black. The -t flag can be used to have xphoon keep running and update the picture every <interval> minutes. (Normally, xphoon just sets the root picture and exits.)

NOTES

The original motivation for this program was that xsetroot was too slow. Loading a full-screen bitmap took about 15 seconds. We made a trivial program that had fullmoon.bitmap compiled in, and it ran in less than a second. (And incidentally, the executable was smaller than fullmoon.bitmap.) Then later we came up with the cheapmoons, the phase hacking, and finally the earthlight.

AUTHORS

Permission to use, copy, modify, and distribute this software and its documentation for any purpose and without fee is hereby granted, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation. This software is provided "as is" without express or implied warranty.

The moon-phase computation is from "moontool.c" by John Walker.

This document was created by man2html, using the manual pages.
Time: 20:51:19 GMT, March 01, 2023